VHL.ResolveFilename
This command returns the ID of a VHL file based on its filename. To to do, the command searches for a file whose configuration value VhlCfg.File.Filename matches the passed Filename exactly.
Use this ID to reference the VHL file in the following commands:
We strongly recommend you don't hardcode file IDs, but always resolve them via this command. Otherwise, your application won't work anymore if e.g. a project manager later merges VHL files into a different configuration using BALTECH ConfigEditor. This process may result in a new ID, but not in a new name.
Properties
- Command code: 0x0110
- Command timeout: 100 ms
- Possible status codes: General status codes, VHL.ErrConfig
Parameters (request frame)
| Name | Type/Size | Description |
|---|---|---|
| Length of FileName | Integer (8 bits) |
Length of FileName in bytes |
| FileName | ASCII string |
Name of VHL file
The filename is case sensitive. Exactly 1 file with the given name must exist. If there are several or no files with exactly this name, VHL.ErrConfig is returned. |
Returned values (response frame)
| Name | Type/Size | Description |
|---|---|---|
| Id | Integer (8 bits) | ID of VHL file |